home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 20 / Cream of the Crop 20 (Terry Blount) (1996).iso / utility / rawed1_1.zip / READ.ME < prev    next >
Text File  |  1996-06-08  |  5KB  |  140 lines
  1. RAWEDIT v1.1 - Hexadecimal File Editor
  2.  
  3. Written by: Ken Martin
  4.  
  5.  
  6. Just a few things about RAWEDIT:
  7.  
  8.     1) It views/edits files in raw hexadecimal numbers/ASCII text.
  9.        RAWEDIT accomplishes this by splitting the screen into two sides:
  10.        the left for hexadecimal numbers, and the right for ASCII text.
  11.  
  12.     2) You can go to any byte position in a file.
  13.  
  14.     3) You can search for any hex- or ASCII- string in a file.
  15.  
  16.     4) Use the TAB key to switch between editing hexadecimal and ASCII.
  17.  
  18.     5) A file can be expanded or a portion saved as a different file.
  19.  
  20.     5) There's a built-in scientific calculator
  21.  
  22.     6) Hex to decimal to binary to ASCII conversion utility
  23.  
  24.     5) RAWEDIT was written for and tested on DOS:
  25.          - Turbo C++ 1.0
  26.          - Watcom C++ 10.0
  27.  
  28.        and Unix:
  29.          - IBM AIX
  30.          - HP HP-UX
  31.          - Sun Solaris
  32.          - Linux
  33.  
  34.     6) All source for recompiling RAWEDIT with any of the abovementioned
  35.        compilers is included.
  36.  
  37.     7) To run, simply type:
  38.  
  39.           rawedit -r <filename>
  40.  
  41.           ... where:
  42.  
  43.               -r          =   Switch to put RAWEDIT in read-only mode.
  44.               <filename>  =   The file to view and/or edit.
  45.  
  46.           Example:
  47.  
  48.              rawedit read.me
  49.  
  50.           This will allow viewing and editing the read.me file in it's
  51.           raw hexadecimal/ASCII state.
  52.  
  53.              rawedit -r rawedit.h
  54.  
  55.           This allows viewing only of rawedit.h.
  56.  
  57.      8) Filelist:
  58.  
  59.         rawedit.exe       Executable under DOS.
  60.         rawedit.aix       Executable under IBM RS/6000 AIX.
  61.         rawedit.hpx       Executable under HP 9000 HP-UX.
  62.         rawedit.sol       Executable under Sun Sparc Solaris
  63.         rawedit.lin       Executable under Linux
  64.  
  65.         rawedit.c         RAWEDIT main source code.
  66.         rawedit.h         Determines which .io file to include
  67.  
  68.         watcom10.io       Input/Output driver for Watcom C++ compiler
  69.         tcc1.io           Input/Output driver for Turbo C++ compiler
  70.         aix.io            Input/Output driver for RS/6000 AIX compiler
  71.         hpux.io           Input/Output driver for HP 9000 HP-UX compiler
  72.         solaris.io        Input/Output driver for Sun Sparc Solaris
  73.         linux.io          Input/Output driver for Linux
  74.  
  75.         make_wat.bat      Batch file for compiling using Watcom C
  76.         make_tcc.bat      Batch file for compiling using Turbo C++ 
  77.         aix.mak           Script for creating rawedit.aix under RS/6000 AIX
  78.         hpux.mak          Script for creating rawedit.hpx under HP 9000 HP-UX
  79.         solaris.mak       Script for creating rawedit.sol under Solaris
  80.         linux.mak         Script for creating rawedit.lin under Linux
  81.  
  82.      9) To recompile under Turbo C++/Watcom C++:
  83.         a) You may need to edit the MAKE_WAT or MAKE_TCC batch file to set
  84.            the correct path(s).
  85.         b) Run MAKE_WAT or MAKE_TCC.
  86.  
  87.     10) To recompile under AIX, HP-UX, Solaris, or Linux:
  88.         a) Use the appropriate .mak file to recompile.  You will probably
  89.            have to do a:
  90.  
  91.               chmod a+x aix.mak
  92.  
  93.                   or
  94.  
  95.               chmod a+x hpux.mak
  96.  
  97.                   or
  98.  
  99.               chmod a+x solaris.mak
  100.  
  101.                   or
  102.  
  103.               chmod a+x linux.mak
  104.  
  105.            ...in order to execute the .mak file as a shell script.
  106.  
  107.            Also, since rawedit.c is writting in ANSI-C, an ANSI-C compiler
  108.            must be available on the Unix system.  Some Unix systems have
  109.            only the K & R compiler.  rawedit.c would have to be converted
  110.            back to the K & R style to recompile in this case.
  111.           
  112.     11) With a minimum amount of effort, RAWEDIT could be ported to other
  113.         environments.  Simply look at the existing .io files as examples
  114.         for the desired compiler/environment.
  115.  
  116.     12) RAWEDIT.H has been changed to automatically include the correct
  117.         .io file if the proper macro-define is made at compile time.
  118.  
  119.     13) One caveat: Adding the calculator meant including a math library.
  120.         While this is no problem under Unix, DOS compilers are notorious
  121.         for having proprietary ways of accomplishing this.  I tried
  122.         practically every compile option on MSVC1.5's DOS compiler but
  123.         kept getting a link error regarding the math library.  Because of
  124.         this, MSVC1.5 support has been dropped.  Any daring soul can
  125.         copy the WATCOM10.io file to MSVC1_5.io and make porting modifications
  126.         as needed for the compile.
  127.  
  128.  
  129.     RAWEDIT is donated to the public domain in hopes it may help better
  130.     those in need of such a utility or even for those who like playing
  131.     with C code.  No warranties nor guaranties are provided; the software is
  132.     donated AS IS.
  133.  
  134.     I'd like to thank all those people who themselves donate source code
  135.     to the public domain.  Their contributions inspired me to write RAWEDIT.
  136.  
  137.  
  138.     Ken Martin
  139.     June 8, 1996
  140.